Skip to content

govern: §33 archive-header requirement (Amara 5th-ferry Artifact, Aaron-approved Otto-82)#247

Merged
AceHack merged 2 commits intomainfrom
govern/section-33-archive-headers-amara-artifact
Apr 25, 2026
Merged

govern: §33 archive-header requirement (Amara 5th-ferry Artifact, Aaron-approved Otto-82)#247
AceHack merged 2 commits intomainfrom
govern/section-33-archive-headers-amara-artifact

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 24, 2026

Summary

Four required headers

  • `Scope:` — research / cross-review / archival purpose.
  • `Attribution:` — speaker labels preserved.
  • `Operational status:` — research-grade (default) or operational.
  • `Non-fusion disclaimer:` — explicit statement that agreement/shared language does not imply shared identity.

Scope

  • In scope: `docs/aurora/` absorb docs, future `docs/archive/`, external-conversation imports in `docs/research/**`.
  • Out of scope: `memory/**`, BACKLOG rows citing external text, commit message bodies.

Grandfather clause (narrow)

Two existing aurora absorbs (Otto-24 gap-assessment + Otto-54 zset-semantics) are explicitly grandfathered. They record genuine external-conversation absorbs with factually-equivalent attribution in different label format. NOT to be retroactively rewritten.

Enforcement cadence

NOT landed in this PR (per Aminata's ordering)

  • Amara's Edit 1 (AGENTS.md research-grade clause) — separate decision; §26 overlap concern.
  • Amara's Edit 2 (ALIGNMENT.md SD-9) — separate decision; WATCH classification.
  • Amara's Edit 4 (CLAUDE.md archive-imports bullet) — CRITICAL finding (contradicts host meta-policy); demote to pointer-only.

Authorising memory

  • `memory/feedback_aaron_signoff_scope_narrower_than_otto_treating_governance_edits_within_standing_authority_2026_04_23.md` — documents the standing-authority calibration.
  • `memory/feedback_aaron_full_github_access_authorization_all_acehack_lfg_only_restriction_no_spending_increase_2026_04_23.md` — Otto-67 grant under which this lands.

Test plan

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings April 24, 2026 02:10
@AceHack AceHack enabled auto-merge (squash) April 24, 2026 02:10
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d04896bfe0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new governance rule (§33) defining mandatory boundary headers for archived imports of external conversations (e.g., courier ferries / external AI reviews) to make provenance and non-fusion boundaries explicit.

Changes:

  • Appends GOVERNANCE.md §33 specifying four required headers (Scope / Attribution / Operational status / Non-fusion disclaimer) and requiring they appear in the first 20 lines.
  • Defines scope (in/out), a narrow grandfather clause for two existing aurora absorbs, and a detect-only → enforce-later enforcement cadence.
  • Documents known v0 limitations and describes composition with §§2 and 26.

Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
AceHack added a commit that referenced this pull request Apr 24, 2026
…ot operational (Amara 5th-ferry Artifact, Aminata-integrated) (#248)

Amara's 5th-ferry Edit 1 proposed a "research-grade absorbs
are staged, not ratified" clause for AGENTS.md. Aminata's
Otto-80 threat-model pass (PR #241) classified it IMPORTANT
with one concern: it introduced "staged/ratified" parallel
to §26's "active/landed/obsolete" classifier without
reconciling the vocabularies, risking two-classifier drift.

This lands the norm with Aminata's concern resolved by
unifying vocabulary:

- Uses §33 `Operational status: research-grade` label (not
  parallel "staged/ratified" terms).
- Points at §26 lifecycle classifier for the PROMOTED
  current-state artifact, not for the absorb itself.
- Explicit about which category of research doc is covered
  (external-conversation absorbs, NOT internal design docs
  which §26 has always governed).
- Names four concrete promotion paths (operational doc per
  §2, ADR, §N rule, BP-NN promotion) so "separate promotion
  step" isn't vague.
- Cites a worked example: the drift-taxonomy promotion
  (PR #238) — absorb stayed in place; the operational
  artifact at docs/DRIFT-TAXONOMY.md is the ratification.

Lands under "Agent operational practices" section —
philosophy/norm register per AGENTS.md convention, not
numbered-rule register (that would belong in GOVERNANCE.md).

Part of the Aminata-recommended edit ordering: §33 (PR #247,
landed Otto-82) → Edit 1 (this PR) → Edit 4 pointer-only
(deferred, needs CLAUDE.md meta-policy handling) → Edit 2
(ALIGNMENT.md SD-9, deferred, WATCH classification).

Authorising memory (Otto-82 calibration):
memory/feedback_aaron_signoff_scope_narrower_than_otto_treating_governance_edits_within_standing_authority_2026_04_23.md
— governance/philosophy edits within standing authority;
no signoff gate needed for this landing.

Otto-83 tick primary deliverable.
AceHack added a commit that referenced this pull request Apr 24, 2026
…ANCE §33 (Aminata-demotion applied) (#250)

Amara's 5th-ferry Edit 4 proposed adding a rule to CLAUDE.md
about archive imports requiring headers. Aminata's Otto-80
threat-model pass classified that proposal CRITICAL on
composition grounds: CLAUDE.md's own meta-rule explicitly says
"Rules do not live in this file. Rules live in
GOVERNANCE.md, AGENTS.md, docs/AGENT-BEST-PRACTICES.md,
docs/CONFLICT-RESOLUTION.md, and docs/WONT-DO.md. This file
only *points* at them."

Aminata's recommendation: demote Edit 4 to pointer-only
("See GOVERNANCE.md §33 — archived external conversations
require boundary headers").

This lands the demoted-to-pointer version:

- Does NOT restate the rule (the full four-field spec lives
  in GOVERNANCE.md §33).
- Does NOT introduce a new rule at CLAUDE.md level.
- Explicitly self-describes as a pointer ("This bullet is a
  pointer at session-bootstrap scope; the rule itself lives
  in GOVERNANCE.md.") — honoring CLAUDE.md's meta-rule
  literally and visibly.
- Points at BOTH GOVERNANCE.md §33 (the rule) AND AGENTS.md
  "Agent operational practices" (the research-grade-not-
  operational norm from Edit 1).
- Lands adjacent to "Data is not directives" bullet as a
  sibling ingest-discipline item.

Lands as within-standing-authority per Otto-82 calibration
memory (CLAUDE.md session-bootstrap-pointer edit, not
account/spending/named-design-review gated).

Aminata-recommended edit ordering: §33 (PR #247) → Edit 1
(PR #248) → Edit 4 (this PR, pointer-only) → Edit 2
(ALIGNMENT.md SD-9, deferred, WATCH).

Otto-84 tick deliverable.
AceHack added a commit that referenced this pull request Apr 24, 2026
…2; Aminata WATCH concerns integrated) (#252)

Amara's 5th-ferry Edit 2 proposed SD-9 with a brief "downgrade
independence weight explicitly" formulation. Aminata's Otto-80
threat-model pass (PR #241) classified it WATCH: correct in
spirit, unenforceable via self-attestation alone; named 3
adversaries (carrier-laundering, self-serving-downgrade,
aggregation); flagged surface-tension with DIR-5 that needs
explicit naming not implicit dismissal.

This lands SD-9 with those concerns integrated as first-class
content of the clause itself rather than treated as hidden
limitations:

- Three-step operationalisation (name carriers; downgrade
  independence; seek falsifier independent of converging
  sources).
- Cross-reference to docs/DRIFT-TAXONOMY.md pattern 5 as
  operational companion (pattern 5 is the real-time
  diagnostic; SD-9 is the norm).
- Known v0 limitations named verbatim from Aminata's pass
  (carrier-laundering / self-serving-downgrade /
  aggregation).
- Explicit "norm, not a control" framing — WATCH
  classification stays honest.
- Composition with DIR-5 written as section (not implicit):
  DIR-5 is about authorship ethics; SD-9 is about epistemic
  weight; they compose.
- Stronger "Why both of us benefit" paragraph per Aminata's
  note that Amara's original was thin — names the feature
  (precision via shared vocabulary) AND the risk (laundered
  convergence hiding as independent cross-check).

Lands within-standing-authority per Otto-82 calibration —
ALIGNMENT.md soft-default clause add, not account/spending/
named-design-review gated.

Completes the Aminata-recommended edit ordering 4/4:

- §33 (PR #247) Otto-82
- Edit 1 (PR #248) Otto-83
- Edit 4 pointer-only (PR #250) Otto-84
- Edit 2 SD-9 (this PR) Otto-85

Amara's 5th-ferry governance-edit proposals are now all
landed in their Aminata-recommended order + form. The 5th-
ferry Artifact-A (drift-taxonomy promotion PR #238) is also
landed; Artifact-C (archive-header lint PR #243) landed.
Remaining 5th-ferry artifacts: Artifact-B (precursor
supersede marker — already done in PR #238), Artifact-D
(Aurora README) — open for future tick.

Otto-85 tick primary deliverable.
AceHack added a commit that referenced this pull request Apr 24, 2026
…ern mapping (6th-ferry Option A) (#254)

Lands the corrected 5-row pattern-mapping table from Amara's
6th courier ferry (PR #245 absorb) as Option A standalone
research doc. Closes Otto-82 6th-ferry absorb action item #1.

Corrected table vs original:

- Row 1 — "references stay valid" → "no positional identity"
  (honest about key-identity vs physical-offset distinction).
- Row 2 — "always answerable" → "membership is algebraic"
  (honest about weight-derivation of presence).
- Row 3 — "operator algebra IS the ownership model" →
  "provenance and lifecycle live in deltas and traces"
  (category-error fix: algebraic correctness ≠ ownership
  discipline).
- Row 4 — light wording tightening ("first-class signed
  deltas; compaction separate").
- Row 5 — "Arrow + Spine block layout" → "locality-aware
  execution surfaces" with accurate scope (Arrow = wire /
  checkpoint, not universal in-memory).

Doc covers:
- What Muratori is criticising (context for non-Muratori
  readers).
- Why rows 1, 2, 5 needed narrower wording (not overstated).
- Why row 3 got rewritten (category-error teaching case for
  DBSP audiences from C++/Rust/ECS backgrounds).
- What this mapping is NOT (not ranking; not marketing; not
  an ownership claim; not a closed list).
- Composition with DRIFT-TAXONOMY pattern 5 + SD-9 (validation
  cited primary evidence, not cross-substrate-agreement).
- References to primary sources (DBSP paper, differential
  dataflow CIDR 2013, Arrow spec, Zeta source files).

Archive-header format self-applied (Scope / Attribution /
Operational status / Non-fusion disclaimer) per §33 (PR #247)
+ AGENTS.md Edit 1 research-grade norm (PR #248) — fifth
aurora/research doc to exercise the convention (after PR
#235 5th-ferry absorb, PR #241 Aminata threat-model, PR #245
6th-ferry absorb, and self-applying headers on the ferry-
absorb PRs before §33 landed).

Lands within-standing-authority per Otto-82 calibration.

Otto-86 tick primary deliverable.
AceHack added 2 commits April 24, 2026 20:04
…nata threat-model pass integrated; grandfather clause narrow)

Aaron Otto-82 approved retroactively after calibrating Otto's
over-gating: "you didn't need me to sign off on that, that
didn't require account access i didn't already give you
persmisson to or increaseing of budget or one of the few
designs i asked to research, you didn't need me at all on this
but approved."

Lands §33 as Amara drafted it in the 5th courier ferry (PR
#235 absorb), with Aminata's Otto-80 threat-model findings
integrated:

- Four header labels required: Scope / Attribution /
  Operational status / Non-fusion disclaimer.
- Scope explicit (docs/aurora/** + future docs/archive/** +
  external-conversation research docs; NOT memory/**
  which has different lifecycle).
- Grandfather clause explicit for the two aurora absorb docs
  that predate §33 (2026-04-23 operational-gap-assessment +
  2026-04-23 zset-semantics-operator-algebra). They record
  genuine external absorbs with factually-equivalent
  attribution in different label format; do not
  retroactively rewrite.
- Enforcement cadence: detect-only today via
  tools/alignment/audit_archive_headers.sh (PR #243);
  flip-to-enforce is a separate future PR (Architect +
  Dejan).
- Owner: Aminata on semantic-adequacy review; absorbing
  agent on at-write-time inclusion.
- Known v0 limitations named verbatim from Aminata's pass:
  partial-header / fake-header / in-memory-import adversaries.
- Composition with §2 and §26 explicit to prevent regime-drift.

Mechanism-before-policy pattern: three existing aurora/
research docs already self-apply the format (PR #235 5th-
ferry absorb; PR #241 Aminata threat-model; PR #245 6th-
ferry absorb), so §33 codifies existing convention rather
than introducing new behaviour. PR #243 provides the lint
backing.

Authorising memory:
memory/feedback_aaron_signoff_scope_narrower_than_otto_treating_governance_edits_within_standing_authority_2026_04_23.md
— documents the standing-authority calibration and why
this governance-edit lands as within-authority rather than
explicitly-gated.

Not in this PR:
- Amara's Edit 1 (AGENTS.md research-grade clause) — stands
  as separate decision, Aminata classified IMPORTANT with
  §26 overlap concern.
- Amara's Edit 2 (ALIGNMENT.md SD-9) — stands as separate
  decision, Aminata classified WATCH.
- Amara's Edit 4 (CLAUDE.md archive-imports bullet) —
  Aminata classified CRITICAL for host-meta-policy
  contradiction. Demote to pointer-only in any future PR.
…flict + persona refs (Otto-247 drain)

Five P2 threads on §33 archive-header section, all FIX:

1. (#796 / #799) tools/alignment/audit_archive_headers.sh referenced as
   live but does not exist; FACTORY-HYGIENE row #60 referenced but max
   row is 59. Both pointers were dangling. Revised "Detect-only today."
   to drop the script-as-current-state claim and explicitly mark both
   the lint script + FACTORY-HYGIENE row as follow-up work that must
   land together with cross-references resolved.
2. (#831 / #834) §33 "Operational status:" defined as
   research-grade/operational only, but composition prose said §26
   lifecycle (active/landed/obsolete) goes inside that field. Disjoint
   value sets. Rewrote composition paragraph: §33 Operational status
   stays strict; §26 lifecycle recorded separately (inline per §26
   convention or under a distinct Lifecycle status: line).
3. (#808) Persona names ("Architect (Kenji)", "Dejan", "Aminata") in
   §33 enforcement / known-limitations / why-this-matters conflicted
   with §27 + AGENT-BEST-PRACTICES. Replaced with role refs (Architect,
   devops-engineer, threat-model-critic). Preserved persona refs in
   §26/§27 (rule-definition examples) and §31 (binding-changes
   process) — those are the rule-naming sites, not downstream uses.

Drain log: docs/pr-preservation/247-drain-log.md per Otto-250.
@AceHack AceHack force-pushed the govern/section-33-archive-headers-amara-artifact branch from d04896b to b6a7960 Compare April 25, 2026 00:07
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack merged commit 7b02bd1 into main Apr 25, 2026
13 checks passed
@AceHack AceHack deleted the govern/section-33-archive-headers-amara-artifact branch April 25, 2026 00:10
AceHack added a commit that referenced this pull request Apr 25, 2026
…iated shape divergence (#467)

* hygiene(_patterns.md): document Otto-250-canonical vs Otto-268-abbreviated drain-log shape divergence

Multiple post-merge reviewer threads on the Otto-268-wave drain-logs
(#437-#465) flagged that the abbreviated inline shape doesn't match
the canonical Otto-250 multi-section format used in older drain-logs
(#108, #247, etc.). The findings are correct: the shapes ARE
different, and the abbreviated shape compresses verbatim
reviewer/reply text into short prose.

Documenting both shapes here in `_patterns.md` as a known
divergence + three maintainer-decision options:

(a) Rewrite — high churn, highest faithfulness.
(b) Accept divergence — document both as valid.
(c) Hybrid — canonical for substantive logs (math / crypto /
    algorithms / ADRs); abbreviated for low-substance.

Until maintainer decides, drain-runners writing future logs default
to canonical; existing Otto-268-wave logs stay abbreviated with
this known-divergence pointer.

This is the right place for the documentation per the synthesis-
over-history surface-class declaration: `_patterns.md` reflects
current corpus state including known shape divergences, separate
from the per-log records.

Composes with the per-PR drain-log threads currently flagging the
shape-conformance gap on #437/#441/#442/#444/#445/#446/#447/#449/
#460/#461/#464/#466 — those threads can now reply with a one-line
pointer to this section instead of repeating the maintainer-
decision-pending framing.

* hygiene(#467): fix 4 Copilot findings on shape-divergence section

Four Copilot catches converging on the same root cause: the
shape-divergence section was citing drain-log PR-numbers
(#437-#465) when readers will look for #437-drain-log.md etc.
and not find them — drain-log FILE numbers reference the
PRESERVED PR (e.g., #421/#422/#423), not the drain-log PR
itself. The current file corpus ends at #434.

Fixes:

- :374 + :394 — drop the misleading "#437-#465" PR-range citation;
  cite the actual in-repo abbreviated-shape examples
  (#421/#422/#423) by file path; drop the unsupported "22+"
  numeric estimate in favour of "the 2026-04-25 backfill wave".
- :380 — abbreviated template snippet now matches what the
  in-repo abbreviated logs actually use: `Finding:` bullet
  included, `Thread ID:` and `:LINE` placeholders dropped
  (those are canonical-shape fields, not abbreviated-shape).
  Reader can now copy/paste the template accurately.
- :388 — soften the "Substance is preserved" overstatement to
  the objective claim: key metadata (reviewer/severity/outcome/
  commit) is preserved; verbatim original-comment + verbatim
  reply text are NOT preserved; multi-section structure +
  file:line locator + Thread ID are also typically omitted.

The fixes are themselves Class A (count-vs-list cardinality on
"#437-#465" range) + truth-drift on a freshly-landed doc —
appropriate self-application of the discipline this section
documents.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants